home *** CD-ROM | disk | FTP | other *** search
/ Network Support Library / RoseWare - Network Support Library.iso / btrieve / xtr401.exe / MAKE_XTA.DOC < prev    next >
Text File  |  1988-06-08  |  3KB  |  84 lines
  1. The utility, MAKE_XTA.EXE, translates Xtrieve definitions into ASCII
  2. files, with a .XTA extension, which contain the keystrokes to rebuild
  3. the definition.  It can translate a file, view, or layout definition
  4. their internal formats.
  5.  
  6. It is useful for moving a file definition from one dictionary to another,
  7. for modifying definitions, or as a means of creating external documentation
  8. for your definitions.
  9.  
  10. At the DOS prompt, type:
  11.  
  12. Make_xta /<Definition Type>:<Name>
  13.          [/D:<Dictionary Path>]
  14.          [/P:<Password>]
  15.          [/O:<Output>]
  16.  
  17. REQUIRED PARAMETERS
  18. Only the first parameter is required.  <Definition Type> must be one
  19. of the following:
  20.  
  21. /V:"<View Name>"
  22.    <View Name> is the descriptive name of your view.  The name must be
  23.    enclosed in double quotes and must be typed exactly as it appears in the
  24.    Xtrieve menu when recalling the view.  MAKE_XTA uses the VIEW.DDF in the
  25.    current directory when converting views.
  26.  
  27. /L:<Layout Name>
  28.    <Layout Name> is the disk name of a layout you want to translate.  You
  29.    do not have to specify a file extension.  When a /L: is encountered,
  30.    ".lyt" is automatically appended to the file name specified.
  31.  
  32. /F:"<Dictionary Name>"
  33.    <Dictionary Name> is the descriptive file name in your dictionary.  The
  34.    name must be enclosed in double quotes and must be typed exactly as it
  35.    appears in the dictionary.
  36.  
  37. OPTIONAL PARAMETERS
  38.  
  39. /D:<Dictionary Path>
  40.    <Dictionary Path> is the directory where your dictionary files reside
  41.    (files with the extension ".ddf").  This parameter is not required if
  42.    your dictionary files are in the current directory.
  43.  
  44. /P:<Password>
  45.    This parameter is required when the dictionary you are accessing has
  46.    security installed.  <Password> is the Master password for the dictionary
  47.    specified with the /D parameter (or the one in the current directory if
  48.    no /D specified).
  49.  
  50. /O:<Output>
  51.    <Output> is the disk file for the translated definition.   You do not
  52.    need to include the file extension because ".xta" will be appended to
  53.    the name you specify.  If this option is not specified, the output will
  54.    be written to the file, "Make_XTA.xta" in your current directory.
  55.  
  56. NOTE:
  57.  
  58. 1) All parameters must be separated by at least 1 space.
  59. 2) The dictionary and password options are ignored when translating
  60.    layout files.
  61.  
  62. ERROR MESSAGES
  63.  
  64. Error codes for MAKE_XTA are the same as BTRIEVE error codes.
  65.  
  66. EXAMPLES
  67.  
  68. 1) make_xta /F:"Address File" /D:b\: /O:address
  69.  
  70.    This example will translate the definition of the file, Address File, from
  71.    the dictionary in the root directory on drive b:, and put the output in
  72.    "address.xta".
  73.  
  74. 2) make_xta /V:"Address View" /O:addrV /P:fred /D:b:
  75.  
  76.    This example will translate the view definition named "Address View".
  77.    The dictionary on drive b: will be accessed and the password is "fred".
  78.    The output will be in "addrv.xta".
  79.  
  80. 3) make_xta /L:address
  81.  
  82.    This example will translate the layout definition from "address.lyt".
  83.    The output will be in "Make_XTA.xta".
  84.